P a g E ! r
                                ~~~~~~~~~~~
                             v1.0  by Morpheus

    Introduction.
    ~~~~~~~~~~~~~

 PagE!r is a sysop pager for Excelsior! BBS. To show you what its features
 are I will simply sum up what happens when a user invokes PagE!r:

  1. PagE!r asks the user the reason for paging the sysop.

  2. PagE!r checks whether the sysop is available or not.

  3. If the sysop is not available then an ansi-screen ("Sysop not available")
     will be shown to the user and PagE!r will ask the user if he wants to
     leave feedback.

  4. If the sysop is available then an ansi-animation will be shown to the
     user while PagE!r notifies the sysop.

  5. The sysop is notified by playing a sound sample and showing a GUI on the
     WB screen which has the gadgets Chat, IUM, Busy, Unavailable, Abort.


    Files.
    ~~~~~~

 The following files should be included in this archive:

    PagE!r/PagE!r               -   The main ARexx script
    PagE!r/PagE!r.txt           -   This text file
    PagE!r/SysopAvail.rexx      -   Utility for (re)setting the avail-flag
    PagE!r/PagE!r.ansi          -   Ansi-anim showed while paging
    PagE!r/NotAvail.ansi        -   Ansi-screen showed when sysop is not
                                    available
    PagE!r/PagE!r.sound         -   The sound sample
    PagE!r/PagE!r_sysop         -   ARexx script invoked by the PagE!r-script
    PagE!r/PagE!r_player        -   ARexx script invoked by the PagE!r-script
    file_id.diz
    libs/rexxarplib.library
    libs/screenshare.library


    Installation.
    ~~~~~~~~~~~~~

 The installation of PagE!r can be quite complicated for some people
 (but not for YOU of course :-) , but I hope it won't stop you from trying
 out this utility!

 1. Copy the two libraries (rexxarplib.library and screenshare.library) from
    the libs directory to LIBS:

 2. Create a new directory for PagE!r (the default path is Doors:PagE!r)

 3. Copy all the files from the PagE!r-directory to the new directory that
    you just created

 4. Edit the file "PagE!r" and change the "path" and "rxpath" settings at
    the top of this file to your settings

 5. (optional) Edit the file "PagE!r_sysop" and change "busymsg" and
    "chatmsg" to messages that are much more fun than mine ;)

 6. Edit the file "PagE!r_player" and change "playcmd", "playwhat", "play_nr"
    and "pause" to the for the sample player you use

 7. (optional) Replace the files "PagE!r.ansi" and "NotAvail.ansi" with
    ansi-anims and/or screens that you like

 8. Add the following line to your BBS-startup file (if you have any, and if
    you don't: create one! :-)

        rx [PagE!r-path]/SysopAvail.rexx [x] [y]

    [PagE!r-path] should be replaced with the path to the SysopAvail-script
    and you can optionally replace [x] and [y] with the coordinates for the
    starting position of the SysopAvail-window.

    For example:

        rx Doors:PagE!r/SysopAvail.rexx 20 40

    this will open a window at the (x,y)-postion (20,40).

 9. Edit your "EX.BBSMenus" file. Go to the Global Commands section and
    find the line for the 'C'-command. This line will look something like:

       501,     C,      0,      "1-32",     ""

    Change this line into :

       501,     COLD,   0,      "1-32",     ""

    Now go to the bottom of the Global Commands section and add the
    following line to it:

       566,     C,      0,      "1-32",     "\#0Doors:PagE!r/PagE!r\"
       ~~~                                      ~~~~~~~~~~~~~
        |                                             |
        `-> Make sure that this is a new              |
            (unused) command-value                    |
                                                      |
                     path where PagE!r is located  <--'

    After reloading the "EX.BBSMenus" file the new pager can be activated by
    entering 'C' at the command prompt.


    Usage of SysopAvail.
    ~~~~~~~~~~~~~~~~~~~~

 Because I have no idea how to check the internal avail-flag in E! with
 ARexx, I have written a small script to set and reset a new avail-flag
 that is used by PagE!r.

 I think that the usage of this utility will be quite clear when you've
 started it.

    - The "Avail"-gadget will set the avail gadget
    - The "Not Avail"-gadget will reset the avail gadget.


    Usage of the GUI.
    ~~~~~~~~~~~~~~~~~

 When you're being paged you will hear a sound sample and a GUI on the WB
 screen will pop to the front. This GUI contains the name of the user that
 paged you, the port number that he/she is on, the reason for paging and the
 following gadgets:

    Chat        -   Activating this gadget will open the BBS screen of the
                    user that paged and pop it to the front. You can now
                    activate the chatter in the "User Menu" of the BBS screen
                    and chat with your user.

    IUM         -   You can enter a message and send it to the user by
                    activating this gadget.

    Busy        -   Activating this gadget will send a standard busy-message
                    to the user.

    Unavailable -   This gadget resets the avail-flag.

    Abort       -   Abort... :)

 After activating one of the gadgets the GUI-window will be closed.


    Registration.
    ~~~~~~~~~~~~~

 All you have to do to register this utility is send me a message with your
 address. It's always nice to know who's using my programs :))


    Author.
    ~~~~~~~

 If you find any bugs, problems or if you've got a great idea for another E!
 door, then mail me at one of the following addresses:

    FIDO:   2:285/1.40
    AmyNet: 39:157/107.4
    NLA:    14:105/204.4

    E-mail: robin@te.xs4all.nl

    Robin Michielsen
    Puntstraat 23
    4543 CW  Zaamslag
    The Netherlands